home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / idxutil2.zip / IDX-UTIL.DOC < prev   
Text File  |  1992-06-01  |  11KB  |  229 lines
  1. PCB-UTIL.DOC - June 01, 1992 - Gary Meeker
  2.  
  3. This document contains information on how to use:
  4.    IDX-DUPS Version 2.00,
  5.    IDX-LIST Version 1.00,
  6.    IDX-EDIT Version 1.00,    (Still not written)
  7.    IDX-DRIV Version 1.00, and
  8.    IDX-RSET Version 1.00.
  9.  
  10.    These programs are released as FREEWARE to all REGISTERED PCBoard
  11. Version 14.5 Sysops.  The Copyright is retained by Gary Meeker.
  12.  
  13.    What does this mean?  If you have purchased a licence for PCBoard V14.5
  14. from Clarke Development, then you are entitled to copy and use these
  15. utilities on as many computers as allowed by your licence from Clark
  16. Development.  If you have an illegal copy of PCBoard V14.5, these programs
  17. are not for YOU.
  18.  
  19. =========================================================================
  20. *DISCLAIMER*DISCLAIMER*DISCLAIMER*DISCLAIMER*DISCLAIMER*DISCLAIMER*
  21.  
  22. Every effort has been made to avoid error and moderately extensive testing
  23. has been performed on these programs, however, I do not warrant them to be
  24. fit for any purpose or to be free from error and disclaims any liability
  25. for actual or any other damage arising from the use of these programs.
  26.  
  27. ENSURE YOU KEEP UP-TO-DATE BACKUPS OF ALL YOUR IMPORTANT FILES.
  28.  
  29. *DISCLAIMER*DISCLAIMER*DISCLAIMER*DISCLAIMER*DISCLAIMER*DISCLAIMER*
  30. =========================================================================
  31. IDX-DUPS Version 2.00   (06/01/92)
  32.    List duplicate entries in a PCBoard 14.5(a) File Index.  To use type:
  33.  
  34.       IDX-DUPS indexname[.IDX]  [indexname2.IDX]]  [/Q]  [/I]  [/Kn]
  35.  
  36. Where indexfile[.IDX] is the name of the index file to display.
  37. (The .IDX file extension is optional.  Do not include the '[' or ']'.)
  38.  
  39. Optionally you may include an indexname2[.IDX] which will be compared against
  40.  the first. Duplicates in the first will still be reported, but any files
  41.  found in the second which are also in the first will also be reported.
  42.  Duplicates in the second index will only be reported if they are also
  43.  in the first.
  44.  
  45.  [/Q] supresses the header info from the output.
  46.  
  47.  [/I] creates a file called COMMON.IDX containing the Index information
  48.   from the second Index when a file matches from the first index.
  49.   You can include a 3rd IndexfileName to override the default name.
  50.   Make sure you don't use the name of a file already on the disk or it
  51.   will be overwritten (unless that is what you want.) New with 2.00 is
  52.   the ability to use /I with a single IndexFile and get a COMMON.IDX
  53.   listing the Duplicates.
  54.  
  55.  [/Kn] Kill Duplicates. n:1=Prompt on all files (default)
  56.                           2=Prompt on different size files
  57.                           3=Don't prompt at all (Use with caution)
  58.  
  59.   This feature only works when two .IDX files are specified. The files from
  60.   the second .IDX files are the ones that will be deleted. If you have a
  61.   CD-ROM, you would want to specify it first and your Hard Disk(s) .IDX file
  62.   second, followed by /K (and 1, 2 or 3... If only /K is specified 1 is
  63.   assumed).
  64.  
  65.  
  66. I setup a CD-Rom conference available to only those Users who contributed
  67. to making the purchase of the CD-Rom Drives & Disks possible. All the
  68. CD-Rom files are available from that conference but not the Main Board
  69. or other Conference Files (accept the Masterfile list Directory.)
  70. I used this to find all the files on my Hard Disks that were also on the
  71. new CD-Roms. I feed DLPATH.LST to MAKEIDX to create an Index for my Hard
  72. Drives. Then using this utility I created an Index of the Duplicates.  I
  73. added both of these (one for each CD-Rom) to the DLPATH.LST and deleted
  74. the files from the Hard Drives. This way I didn't loose any files from my
  75. board available to everyone but was able to free up the storage space they
  76. were taking up. My Users could not tell the difference and everyone was
  77. happy. Once IDX-Edit is finished I can add some of the files on the CD-Rom
  78. to these Indexes to help fill out some of the Conferences which are bare
  79. of files right now. I could copy the files from the CD-Rom to the Hard Drives
  80. and create another Index of the Dups to add them in, but it will be easier
  81. after the routine gets finished.
  82.  
  83. =========================================================================
  84. IDX-List Version 1.00   (01/01/92)
  85.    List entries in a PCBoard 14.5(a) File Index.  To use type:
  86.  
  87.       IDX-LIST indexname[.IDX] [filemask]
  88.  
  89. Where indexname[.IDX] is the name of the index file to list.
  90. (The .IDX file extension is optional.)
  91.  
  92.  and [filemask] is the file or wildcard match to list."
  93.  
  94. =========================================================================
  95. IDX-Edit Version 0.20   (01/01/92) Preliminary Information only.
  96.    Edit entries in a PCBoard 14.5(a) File Index.  To use type:
  97.  
  98.       IDX-EDIT [indexname[.IDX]
  99.  
  100. Where indexname[.IDX] is the name of the index file to edit.
  101. (The .IDX file extension is optional.)
  102.  
  103. If not given, the file name will be prompted for.
  104.  
  105. This will be the most powerful Utility of the 3 once it is finished. It
  106. will allow for complete editing of the data in the index file. You will
  107. be able to TAG files based on Duplicates, a FileMask or manually. The
  108. Tagged files may then be deleted (or untagged manually). Files will be
  109. able to be inserted also. Plans are also to allow Tagging or Inserting
  110. files by reading a file for Paths\FileNames. Editing of Paths will also
  111. be possible to allow easy changing of drive letters, etc. Paths will be
  112. able to be added or deleted. Other features will be available if I come
  113. up with any or requests are made, and I can work them in.
  114.  
  115. Currently only Displaying and Editing are finished.
  116. =========================================================================
  117. IDX-DRIV Version 1.00   (06/01/92)
  118.    Set Drive Letter on all paths in a PCBoard 14.5(a) File Index. To use type
  119.  
  120.       IDX-DRIV indexname[.IDX]  DriveLetter  [/Q]
  121.  
  122. Where indexname[.IDX] is the name of the index file to set.
  123.  
  124. DriveLetter is the Drive Letter to assign to all paths
  125.  
  126. [/Q] supresses the header info from the output.
  127.  
  128. IDX-DRIV is designed to modify the Paths in an IDX file to whatever drive
  129. letter you desire (This is quicker than using MAKEIDX again just because
  130. you changed the drive letter).
  131. =========================================================================
  132. IDX-RSET Version 1.00   (06/01/92)
  133.    Set Active CD-Roms and Drives in a PCBoard 14.5(a) File Indexes. To use type
  134.  
  135.       IDX-RSET ConfigFile  [/Q]"
  136.  
  137. Where: ConfigFile = Drive:Path to our configuration file.
  138.  
  139. [/Q] supresses the header info from the output.
  140.  
  141.  
  142. The ConfigFile contains 4 or more lines:
  143. Line 1: Loc/Name of the CDROM database File
  144. Line 2: Place CD-ROM Index Files at Beginning of DLPATH.LST files.
  145. Line 3: Number of DLPATH.LST files to check
  146. Line 4+ Loc/Name of each DLPATH.LST file to be checked/altered
  147.  
  148. The CDROM database File contains 3 or more lines
  149. Line 1: Number of CD-ROMS listed in database, List of Drives for CD-ROMS
  150. Line 2+ CDRom Name Label, Loc/Name of IndexFile, TestFile
  151.  
  152.  
  153. IDX-RSET is designed to assist in changing CD-ROMS if you have more CD-ROMS
  154. than drives. First create an Index file for each CD-ROM using MAKEIDX. Next
  155. create the CDROM DataBase file using a text editor. Line 1 defines how many
  156. CD-ROMS will be listed in the data base and a list of CD-ROM Drive letters
  157. with no spaces or seperators (ie. STU or STUVWX). The following lines include
  158. a label for identifying the CD-ROM (used only as output name for your use)
  159. (but NOTE: DO NOT include a comma in the label)), the Drive:\Path\Filename
  160. of the indexfile for this CD-ROM, and a test file unique to this CD-ROM to
  161. allow the program to identify the CD-ROM (DO NOT include a drive letter or
  162. leading :\ for the path.)
  163.  
  164. Example (I have 2 CD-ROMS and 1 Drive)
  165.  
  166. 2,S
  167. CD-Rom1, H:\IDX-ROM1.IDX, ROM01\1603.ZIP
  168. CD-Rom2, H:\IDX-ROM2.IDX, ROM201\ALTBRN12.ZIP
  169.  
  170. Next create the config file using a text editor. The first line contains
  171. the Drive:\Path\Filename of the above database. The second line determines
  172. if the CD-ROM Index files should be listed at the beginning (YES) or the
  173. end (NO) of the DLPATH.LST files (NOTE: a special mode is available by the
  174. use of AUTO which causes the Index files to be listed after the end of the
  175. first occurances of INDEX files in the DLPATH.LST file). The third Line
  176. contains the number of DLPATH.LST files to be checked. The following lines
  177. contain the Drive:\PATH\Filenames of each of the DLPATH.LST files.
  178.  
  179. When run, IDX-RSET will Check each CD-ROM listed and determine which drive
  180. it is in. It will then modify the INDEX file so the PATHS will contain the
  181. proper Drive letter. Once each CD-ROM is located it will read each of the
  182. DLPATH.LST files listed and look for INDEX files. If the Index File is one
  183. of the files listed, it will be skipped. Any other INDEX file as well as any
  184. other line will be copied to the new DLPATH.LST file which will then be
  185. renamed to the origional file. The result will be a DLPATH.LST file which will
  186. contain the proper index files for the CD-ROMS that are found to be online
  187. and the index files modified so the paths contain the proper Drive letter.
  188. =========================================================================
  189.  
  190. CONTACTING THE AUTHOR
  191.  
  192. There are a number of ways to contact the author:
  193.  
  194.    1.  Call the support BBS, SHARP Technical Support Line BBS (404) 962-1788.
  195.  
  196.    2.  Fax: (404) 995-0613
  197.  
  198.    3.  Send net mail message through one of the mail networks in a CD-Rom
  199. Sysops, PCBoard, QuickBasic or TeleMate Conference addressed to 'Gary Meeker'.
  200. Available networks are Intelec, Rime, ILink and P/Net. Although I sometimes
  201. do not get on the networks for a couple months at a time, so my BBS or P/NET
  202. which I do carry on my BBS is the quickest bet.
  203.  
  204.  
  205.    4.  Send letter through regular post to the following address:
  206.  
  207.          ATTN: Gary Meeker
  208.          SHARP Technical Support Line BBS
  209.          725-C Old Norcross Road
  210.          Lawrenceville, GA 30245
  211.  
  212. =========================================================================
  213. Source Code:
  214.  
  215. All programs are written in QuickBasic 4.5 and compiled using P.D.Q.
  216. from Crescent Software. This results in very small code. Also several
  217. routines from Crescent's QuickPack Professional Library and some of myown
  218. Library routines were used.
  219.  
  220. For those who would like source code, it can be obtained by sending $10
  221. to the address above, made payable to Gary Meeker. Specify 3.5" or 5.25" &
  222. DD or HD format disks. You will receive the QB4.5 source code and the
  223. assembly code and Library for myown routines. To compile the code you will
  224. need P.D.Q. & QuickPack Professional from Crescent Software or replace the
  225. Library calls by uncommenting the internal routines which accomplish the
  226. same functions but result in larger code. Compiling then can be done under
  227. QB4.5 just fine. (although the files will be 2 to 4 times as large.)
  228. =========================================================================
  229.